When you create a storage aggregate, you specify a name for the aggregate and a number of disks to be added to the aggregate. You can optionally specify the aggregate's home node (that is, the node on which the aggregate is located unless the aggregate fails over to the node's storage-failover partner), a list of specific disks that are to be added to the aggregate, the RAID type for RAID groups on the aggregate, the maximum number of disks that can be included in a RAID group, and whether the aggregate holds normal FlexVol™ volumes or FlexVol–High Performance Option volumes. See Chapter 12, Managing File Striping for information about volume types.

The following example creates an aggregate named node_1_b_aggr2 on a home node named node1b. The aggregate includes 30 disks and uses RAID-DP. The maximum number of disks in a RAID group on the aggregate is 10. The aggregate holds normal FlexVol volumes.

node::> storage aggregate new -aggregate aggr2 -node node1b
-diskcount 30 -raidtype raid_dp -maxraidsize 10 -voltype flex

To display information about storage aggregates, use the storage aggregate show command. By default, the command displays the following information about all storage aggregates:

Other information is displayed in a detailed view and if other parameters are specified. See the reference page for the command for details.

The following example displays information about all storage aggregates.

node::> storage aggregate show
Aggregate Size(MB) Used%    State  #Vols  Node(s)   RAID Type   RAID Status  
foobar    116262     55%    online     3  node1a    raid_dp     raid_dp
node_1_a_aggr0
          116262     24%    online     2  node1a    raid_dp     raid_dp
node_1_b_aggr0
          116262     90%    online     1  node1b    raid_dp     raid_dp
node_1_b_aggr1
          116262      1%    online     0  node1b    raid_dp     raid_dp

You can add disks to an existing aggregate by using the storage aggregate add command. You must specify the number of disks that are to be added to the aggregate. You can optionally specify a list of specific disks that are to be added to the aggregate; the number of disks in the list must match the number of disks specified by the value of the -diskcount parameter. You can also optionally specify a RAID group to which to assign the disks.

The following example adds 20 disks to an aggregate named node_1_b_aggr2.

node::> storage aggregate add -aggregate node_1_b_aggr2 -diskcount 20

The storage aggregate modify command enables you to modify the following attributes of a storage aggregate:

To change an aggregate's name, use the storage aggregate rename command.

The following example modifies all RAID groups on an aggregate named aggr1 to use RAID-DP and to have a maximum of 25 disks per RAID group.

node::> storage aggregate modify -aggregate aggr1 -raidtype raid_dp
-maxraidsize 25

You can use the storage aggregate rename command to rename a storage aggregate. The following example renames an aggregate named aggr2 to the name node_1_b_aggr2.

node::> storage aggregate rename -aggregate aggr2
-newname node_1_b_aggr2

The storage aggregate scrub command controls the scrubbing of a storage aggregate for parity errors. You can optionally specify a single RAID group to be scrubbed on the aggregate. The command enables you to start, stop, pause, restart, and display status information about scrubbing.

The following examples start a scrub of a storage aggregate named aggr3, then query the status of the scrub.

node::> storage aggregate scrub -aggregate aggr3 -action start
node::> storage aggregate scrub -aggregate aggr3 -action status
Scrubbing is running on aggr3 with 1% completed.

To delete a storage aggregate, use the storage aggregate delete command. The command fails if any volumes exist on the aggregate. The command prompts you for confirmation before running.

The following example deletes an aggregate named aggr3.

node::> storage aggregate delete -aggregate aggr3
WARNING:          Are you sure you want to destroy this aggregate? (y or n): y